home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 7: Sunsite / Linux Cubed Series 7 - Sunsite Vol 1.iso / system / news / inn1.000 / inn1.4sec-linux-src.tar / inn / tools.linux / INSTALL-linux < prev    next >
Text File  |  1994-05-20  |  4KB  |  134 lines
  1. INN (InterNetNews) for Slackware and Debian Linux
  2. =================================================
  3.  
  4. This is the INN binary distribution for Linux.
  5.  
  6.  
  7. System requirements:
  8. --------------------
  9.  
  10.     - ld.so
  11.     - libc.so.4 -> libc.so.4.5.19
  12.     - smail or sendmail mail package
  13.  
  14. Slackware 1.1.2 and possibly Debian, too, are platforms where
  15. inn runs without problems.
  16.  
  17.  
  18. INSTALLATION:
  19. -------------
  20.  
  21. a) Unpack the package with your proper package tools
  22.    On Slackware Linux this is the utility pkgtool.
  23.  
  24. b) Make sure that your system has a user and group "news"
  25.    and that you use the same UID and group ID !
  26.  
  27.    /etc/passwd
  28.         news::9:13:news:/usr/lib/news:
  29.               |  |____ GID 13 !
  30.               |_______ UID 9 !
  31.  
  32.    /etc/group
  33.         news::13:news
  34.                |______ GID 13 !
  35.  
  36. c) There must be a mail alias for the user usenet
  37.    in /usr/lib/aliases, since some scripts want to send mail
  38.    to ``usenet''.
  39.  
  40.    /usr/lib/aliases:
  41.         news: root
  42.         usenet: root
  43.  
  44.    Rebuild the dbm alias database with the command:
  45.  
  46.     # newaliases
  47.  
  48. d) Add the inn startup script ``rc.news'' to your system 
  49.    start procedure rc.local (mostly found in /etc or /etc/rc.d:
  50.  
  51.     # start inn
  52.     /usr/lib/news/etc/rc.news
  53.  
  54. e) copy the crontab sample file crontab-news
  55.    to /usr/spool/cron/crontabs/news and modify it.
  56.    Change the name of your news backbone.
  57.  
  58. f) Note, that the news LIBDIR is now in /usr/lib/news.
  59.    Since many newsreader are preconfigured to expect news config
  60.    files in /usr/local/lib/news you should make a symbolic link
  61.  
  62.     # ln -s /usr/lib/news /usr/local/lib/news
  63.  
  64.   Possibly you have to remove the directory /usr/local/lib/news
  65.   first if it already exists from an older cnews installation.
  66.  
  67. g) The News spool directory is /var/spool/news. If you have already
  68.    news articles on your system, but in a different location, then
  69.    remove the directory /var/spool/news if it already exists
  70.    and make a symbolic link to your news spool directory (for example
  71.    to /news):
  72.  
  73.     # ln -s /news /var/spool/news
  74.  
  75. h) Modify the news config files in /usr/lib/news:
  76.  
  77.    The entries are from my running system.
  78.    manlobbi is the news server, knobel - my site - is the news client.
  79.    You should browse through the following files in /usr/lib/news:
  80.  
  81.     expire.ctl hosts.nntp inn.conf moderators newsfeeds 
  82.     nnrp.access nntpsend.ctl passwd.nntp
  83.  
  84. i) create an empty history database and log files
  85.  
  86.      :>/usr/lib/news/history
  87.      :>/usr/lib/news/history.dir
  88.      :>/usr/lib/news/history.pag
  89.      :>/usr/lib/news/errlog
  90.      :>/usr/lib/news/log
  91.      chmod 664 /usr/lib/news/{history*,log,errlog}
  92.      chown news.news /usr/lib/news/{history*,log,errlog}
  93.  
  94. j) run the script makekdirs.sh as root.
  95.  
  96. k) Read the manual page news-recovery(8). It contains information
  97.    how to recover your news system after upgrading to inn.
  98.  
  99. l) Make sure the your uucp Permission file allows uux to
  100.    run the scripts rnews or grnews 
  101.  
  102.    If you have taylor uucp using taylor uucp config style then
  103.    edit for example the file /etc/uucp/sys ....
  104.  
  105.     commands /usr/bin/uucp /bin/rmail /usr/lib/news/rnews /usr/lib/news/grnews 
  106.  
  107.  
  108.  
  109. m) Examine your /etc/syslog.conf file. The default with Slackware is
  110.  
  111.    *.warn             /usr/adm/syslog
  112.  
  113.    Which causes a syslog entry AND a disk access for every arriving article
  114.    with unbatched nntp. (One could also use batching :-)
  115.  
  116.    I changed mine to
  117.  
  118.    *.err              /usr/adm/syslog
  119.  
  120. n) Start innd if you haven't already
  121.  
  122.    /usr/lib/news/etc/rc.news
  123.  
  124.  
  125.  
  126.  
  127.  
  128. And finally:
  129.  
  130.  
  131. PLEASE READ THE DOCUMENTATION ABOUT HOW INN WORKS.  It will help you
  132. a lot to come from a position of understanding the architecture of INN.
  133.  
  134.